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Introduction 

This document supports software for the SunOS™ Release 4.0 installed on Sun-2™, Sun-3™, and Sun-4™ systems. 
Woricstations may be configured as standalone systems, diskless or dataless clients, or homogeneous or heterogeneous 
servers. Workstations may be installed from 1/2-inch or 1/4-inch tape and must have a minimum of 4 megabytes of 
memory. For ERRATA specific to releases that update documention after 4.0.1, see the Release/Upgrade Box 
shipped with a specific release. 

Co-packaged with the 4.0 distribution tapes you will find SunOS release 4.0.1. SunOS 4.0.1 is a collection of fixes 
for bugs discovered in SunOS 4.0. Please complete the installation of SunOS 4.0 and boot and check the operation of 
your workstation(s) before proceeding with the upgrade to SunOS 4.0.1. Information on SunOS 4.0.1 is provided in 
the SunOS 4.0.1 ERRATA, attached at the end of this document as Appendix G. 

This document is divided into various sections to help you obtain the information you need to install and use this 
release. Under the heading Installation Issues, you will find general installation information that is important to all 
users. 

The section Known Problems in the Software is divided into a series of headings to help identify the areas that are 
appropriate to yom installation and us^e needs. 

Documentation Errata and Addenda contains changes to Release 4.0 documentation. 

Finally, there are appendices at the end of this RTF that contain the following: 
a Boot PROM Issues 

□ Sizing Your Disk Partitions 

□ Remote Installation Notes 

□ Kernel Configuration Procedures 

□ Performance Tips 

o Sun-2, Sim-3, and Sun-4 Distribution Tape Layouts 

□ SunOS 4.0.1 Bugfix ERRATA 

Getting Help 

If you have any problems installing or using Release 4.0, call Sim Microsystems at: 1-800-USA-4SUN (1-800-872- 
4786). 


msun 
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Sun Customers throughout the world have service hotlines available for both software and hardware support ques¬ 
tions. Outside the USA, call you local support office or the number provided with your software support contract. 
Have your system model number and the SunOS release number (for software) ready to give to the dispatcher. 

You can also send questions by electronic mail to sun! hotline. Be sure to include your name, company, phone 
number, and SunOS release number in your mail message. 

If you have questions about Sun’s support services or your shipment, call your sales representative. 

□ To see the SunOS release number, type: cat /etc/motd 



Installation Issues 

Installation is separated into three parts: pre-installation issues that should be considered before actual procedures 
begin; issues wito Installing the SunOS 4.0; and post-installation considerations. 


Pre-InstaUation Issues 


1. SunOS 4.0 is a major new release that includes significant changes to the filesystem layout. As a result, upgrad¬ 
ing from releases prior to SunOS 4.0 is not possible. You must do a complete new installation. Back up your cus¬ 
tomized and user files, do a complete installation of SunOS 4.0, and then restore the saved files. (As always, full 
dumps should be done prior to re-instaUing your system.) 


2. Refer to Appendix A of this document, PROM Issues, to find out if you need an updated boot PROM. 



3. As in previous releases, it is recommended that networks be configured with servers more powerful than their 
clients (especially for diskless operation). SunOS 4.0 has improved heterogeneity, file caching and buffer 
management features that make the benefits of this arrangement more api^rent. 


4. For Sun-3 and Sim-4 machines with 1/4-inch tape drives, choose the st 8 option for 1/4-inch tape type. 

5. If you have a Sun lOOU with an Archive 1/4-inch tape controller, you cannot boot MUNIX and use format to 
format and label your disks. Instead, use the diag program from Release 3.5 to format and label your disks. 


6. Disk labeling: the importance of partition ‘c’: 

By Sun convention, every disk drive must have a ‘c’ partition which starts at sector zero (0) and is the fiill size of 
the disk. AH format default labels follow this convention. Please note that if the ‘c’ partition is not correctly 
designated on a drive, suninstall will not ‘see’ it; that is, it will not show up in the Disk Form. 


7. If you have a Fujitsu-M2284/M2322 disk and are using format to relabel your disk, the standard label is 
incorrect because the starting cylinder for the swap partition is wrong. If you want to use the standard label, 
edit /etc/format. dat. Go to the section for this particular disk and change b=105 to b=50. 


Issues on Installing the SunOS 

1. When installing a system which uses a serial terminal as console and setting the terminal type to other, certain 
other non-Sun terminal types may cause suninstall to dump core later on during the installation. This prob- 
lem stems from an inadequate buffer for parsing the termcap file. Work around this as follows: 
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/ ; 


Before entering suninstall, set the TERMCAP environment variable to the termcap entry with these 
keyins; 

# setnoglob 

# eval 'tset -s terminaljype' 

# unset noglob 


2. Setting the correct time zone in suninstall: 

When suninstall is invoked, it will request information on your local time zone. There is no default for this infor¬ 
mation tmd it must be filled in when asked for. See Appendix B of Installing the SunOS 4.0 for a complete listing 
of world timezones. 

3. If you are installing a server, instaling a system which may become a server at a later date, using a system as a 
remote installation server, or planning on adding Sun software after installing the SunOS, answer y to 
Install files category on the Software Form: 

Install files: y 

. . ..... . 


This win load setup_exec (8) and other system administration utilities. 


4. If the "Security" software is selected, then the "System_V" software must also be selected. If it is not, the 
C2conv script used to configure C2 security wiU fail attempting to execute /bin/id. 


5. 


The suninstall. log file: 


After completing an instaUation and before booting the newly instaUed system, review the file 
/usr/etc/install/f iles/suninstall. log. Errors from utilities such as tar wiU appear here even 
if they were scroUed off the screen during the instaUation. 


6. InstaUing from mixed types of distribution tapes: 

suninstall does not currently support instaUation of the different architectures on a heterogeneous server from dif¬ 
ferent tape drives. For example, you cannot instaU a Sun-3 heterogeneous server by loading the Sun-3 software 
from a local 1/2-inch tape drive and the Sim-2 software from a remote 1/4-inch tape drive. If such an instaUation 
is necessary, instaU the machine as a homogeneous server (be sure to select Install optional software), bring 
up the SunOS and then use setup_exec and setup_client to add the heterogeneous software and 
clients. 


Post-InstaUation Issues 

1. Booting Ethernet interface e c 0 from fast servers: 

Diskless Sxm-2s (or Sun l(X)Us) with 3Com Ethernet interface (ecO) wiU have trouble booting from fast servers 
such as Sun-3s or Sun-4s. To correct this, apply the foUowing patch. 

On the machine named SERVER, do the foUowing for the client named CLIENT: 
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Server# cd /export/root /clienoj 
SERVER# echo 'nfstai*e+0x22?«800' 
SERVER# 


adb ‘'w vnuinix 


Also, be sure that the client’s /etc/f stab entries have the rsize and wsize options set to 2K for any fast 
servers. For example, the entry for usr on the CLIENT should look similar to the following: 

— ^— ■ — ' .. ■■ ^ 

SERVER: /export/exec/sunS /usr nfs ro,rsize=2048,wsize=2048 0 0 


Alternatively, the ec board should be upgraded to a Sun multibus Ethernet board (ieO); see your sales 
representative for details. 


2. The symbol LOGHOST is not correctly defined by syslogd on loghost machines. This results in 100% CPU 
usage and syslogd accumulating large amoimts of CPU time. 

To prevent this problem, insert the following line at the beginning of /et c/ syslog. conf on loghost 
machines: 


define(LOGHOST, 1) 


3. Even if a machine is chosen as a yp server during suw/w/a//, it is still necessary to run /usr/etc/ypinit 
on the server before booting clients. After doing this, edit /etc/r c. local and remove the comment sym¬ 
bols from the lines of code referring to ypbind. If you do not do this the yellow pages will not woik on the 
server. 

4. The directory /mann is missing under /usr/man; this results in catman failure. To prevent this problem, 
create the directory mann under /usr/man: 

# nikdir /usr/xaan/maxiA 


Known Problems with the Software 

System Administration Issues 

1. File system blocksize must be >= system page size. 

The system will not support the use of file systems with a block size that is smaller than the page size of the sys¬ 
tem. An example would be a file system with a blocksize of 4K bytes used on a Sun-3 (8K page size). Such file 
systems should be recreated with an appropriate block size. This problem does not affect file systems with a 
block size larger than page size. For example, a block size of 8K on a Sun-2 (2K page size) works properly. 
System page sizes are: Sun-2 - 2K; Sun-3 - 8K; Sun-4 - 8K. 
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2. core files appear to be very large: 

A core file of a dynamically linked program produced by 4.0 appears to be very large, having a length over 
2Mbytes in many cases (as shown by an Is -1 command). However, their actual size on disk (as shown by an 
Is -s) is often much less, usually less than it would be with previous versions of the system. Such files contain 
one or more ‘holes’ of unused space that are optimized out of the disk space allocation. 

If such files (or for that matter, any file containing a hole) are copied using a command such as cp or tar, the 
‘holes’ will be fiUed in and as a consequence the file will actually occupy the amount of disk space indicated by 
its length. This is not a problem if the files are renamed (via mv) or dumped with dump. 


Graphics Issues 

1. In SunCGI, one can specify that the view surface be retained. When this view surface is redisplayed (when the 
window is overlapped or Redisplay is selected from the menu), the image shifts to the right. This effectively 
negates the utility of having a retained view surface. Use canvases if retained data is a must. Otherwise, 
avoid using the retained flag to open_vws. 

2. In GPSI, lines drawn using the XF_LINE_INT_2D, and INT_3D commands seem to be shifted off of the left side of 
the screen where they are clipped (one pixel usually remains on the screen). This happens regardless of the 
viewport and transformation matrix used. Use XF_L1NE_FLT_2D or FLT_3D commands instead. There is no 
work around for users of the INT package. 


SCSI/SMD Issues 

1. Stm 3/2xc and Sun 4Pxx workstations configured with an SMD disk plus two or more SCSI devices may hang 
tmder heavy load. Prevent this problem by upgrading to SunOS 4.0.1, specifically the "SCSI" and "mb" fixes. 

2. On workstations using SMD disks supported by the Xylogics 450/451 disk controller messages may appear in the 
following form: 

r . ...I ...I Ml. Ml. I. .. I . I .... . Ml,-... , M . , ■ 

xy<disk partition>: read/write retry (message) blk #xxxxx^ abs blk #xxxxx 

s_ 

The message may be one of: 

disk sequencer error 
cylinder & head header error 
memory addr error 
header not found 
lost interrupt 

Occasional retry or restore messages are normal and are not cause for concern, and indicate that the I/O operation 
ultimately succeeded. If the message states that the operation ‘failed’, you should be more concerned. In particu¬ 
lar, read operations that fail with ths message ‘hard ecc error’ may indicate worn cabling, poor drive grounding, 
or possible drive problems. 


microsystems 
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Sun FORTRAN and Sun PASCAL Issues 

Sun FORTRAN 1.1 and Sun Pascal 1.1 are separate, value-added products that wiU be shipped subsequently to 
SunOS 4.0. f 7 7 and pc, the UNIX FORTRAN and Pascal compilers have been removed from SunOS 4.0 tapes. 
Customers with support contracts are eligible to receive a one time upgrade to SunOS 4.0 versions of Sun FORTRAN 
and Sun Pascal free of charge. Other customers may purchase these as separate products. 

Sun FORTRAN has many new features including performance enhancements and VMS extensions. Sun Pascal is 
ISO Pascal with separate compilation, variable-length strings, a variety of extensions, and global optimization. 

For additional information, please call your sales representative. 


Unbundled Product Issues 

Some Sunlink products cause diskless nodes to hang during boot: 

In order to install Sunlink products that contain kernel drivers on diskless nodes running 4.0, the configuration file 
line for the system’s Ethernet device MUST be placed BEFORE the config file lines that define the z s ports. 


Old: 

device 

zsO 

at 

obio 

7 

csr 

0x20000 

flags 3 priority 3 


device 

zsl 

at 

obio 

7 

csr 

0x00000 

flags 0x103 priority 

3 

device 

ieO 

at 

obio 

7 

csr 

OxcOOOO 

priority 3 


New: 

device 

ieO 

at 

obio 

7 

csr 

OxcOOOO 

priority 3 


device 

zsO 

at 

obio 

7 

csr 

0x20000 

flags 3 priority 3 


device 

zsl 

at 

obio 

7 

csr 

0x00000 

flags 0x103 priority 

3 


Documentation Errata and Addenda 

There are several miniboxes shipped with this release. In each box, you will find a READ THIS FIRST that pertains 
to the information exclusive to Ae manuals contained in the specific box. Be sure and read these RTFs as well as this 
errata for complete information about the release. 

SunOS Reference Manual 


1. In the printed versions of the Reference Manual pages listed below, the indicated files are incorrectly shown as 
residing in /etc. The on-line versions correctly show these files as residing in /usr/etc: 


audit_warn(8) 
audit d(8) 
config(8) 
devnm(8) 
lockd(8C) 


/usr/etc/security/audit/audit_warn 

/usr/etc/auditd 

/usr/etc/config 

/usr/etc/devnm 

/usr/etc/rpc.lockd 
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routed(8C) /usr/etc/in. routed 

sendmail(8) /usr/etc/sendmail 

statd(8Q /usr/etc/rpc. statd 

2. The printed version of the ini t (8) Reference Manual page incorrectly states that for a secure system, when the 
console is marked secure in /etc/ttytab, a root password is required before the system comes up in 
single-user mode. The on-line page correctly states that when the console is not marked secure, the root pass¬ 
word is required. 

System and Network Administration 

1. Changes and additions to System and Network Administration, Section 9.5, Changing Swap Space: 

There are two ways to expand the local swap space of a standalone (or server) system. 

I. Re-run suninstall. It is permissible to EXPAND the size of the ‘b’ (swap) partition while in the Disk form. 
If you need to REDUCE the size of the‘b’partition you must use MUNixand format. 

II. Add swap space in a regular file; these keyins create a swap file using mkfile(8): 


- —-— \ 

t mkfile -v 84xa /escpoxt/swap/localswap 

/aiqport/aw^rp/localswap 88080384 b3fta9 



Add a swap entry to /etc/f stab: 



On subsequent boots, swapon (8) will be automatically executed by /etc/rc. 

2. Whenusing mkfile(8) to create client swap files fornormtd use DO NOT use the -noptionto 

mkf ile (8). This option creates an empty file with no disk blocks allocated. This will result in a discontiguous 
(and therefore less efficient) swap file for the client It also risks client failure if it attempts to allocate blocks to 
the swap file and none are available. 


This feature of mkf ile (8) and NFS can be used on an experimental basis to determine efficient swap file sizes 
for clients. Note that while Is -1 will show the maximum size for a file made using mkf ile -n. Is -Is 
will also show the actual number of disk blocks allocated to the file: 



# Jokflle -A iSnt ittb 

# inkfile ISm full 

# is -Is 




A 


16392 «..«t 

1 root 

16777216 

full 


V . 

16 -rw-1 

1 root 

16777216 

mt 

.^ 


After making a swap file with mkf ile -n, boot up the client and use it for awhile. Then check how many 



sun 
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blocks have actually been required for normal operation of the client. Add some more room to avoid overrunning 
your swap space later and create the production swap file for the client: 

# nikfile [6/ock$]k f&xpo:^/dwp/clientname 

V_____-_ > 


Release 4.0 Change Notes 

Chapter 2, Section 2.3: Shared Libraries 

By default, programs are built to access shared libraries. This is the standard behavior and can only be changed 
through the use of the -Bst at ic flag. See the Id ( 1 ) man page for more information. 

Chapter 2, Section 2.3: Kernel Boot Sequence 

The kernel boots with the root filesystem initially mounted read-only. This allows f sck to repair any damaged 
filesystems reliably. The root filesystem can be initially mounted read/write by using the new -w option when 
booting. 

Chapter 2, Section 2.7: Utilities 
fsck(8): 

f sck ( 8 ) now checks the raw device by default f sck (8) is unreliable in checking filesystems currently 
mounted read-write since the filesystem activity can interfere with f sck (^ratioa 

mount(8): 

A new remount option for the mount (8) command allows converting 4.2 filesystems moimted as read-only to 
read-write. This facility is used in the re scripts to remount 4.2 filesystems as read-write after the filesystems 
have passed f sck. 

Chapter 2, Section 2.9: System V Enhancements 

The definition for the largest shared memory segment has been changed from SHMPOOL in Release 3.x to 
SHMSIZE in Release 4.0. 

Sun-4 Assembly Language Reference Manual 

Correction to Sun-4 Assembly Language Reference Manual, pages 17 and 18 of Table 2-3: 

The following SPARC floating-point instructions are not supported in the SunOS 4.0 release version of tiie Sun-4 
SPARC assembler: FINTRZ, FCLASS, FEXPO, FSCALE, FREM, and FQUOT. 
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APPENDICES to the SunOS 4.0 ERRATA 


□ A. Boot PROM Issues 

□ B. Sizing Your Disk Partitions 

o C. Remote Tape Installation 

□ D. Kernel Configuration Procedures 

□ E. Performance Tips 

□ F. Sun-2, Sun-3, and Sun-4 Distribution Tape Layouts 
o G. SunOS 4.0.1 ERRATA 
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A: PROM Issues 

□ Minimum boot PROM revision levels: 

If you have a Sun-3 system and try to load SunOS Version 4.0 from a 1/4-inch tape drive, the boot may fail and 
an error code may appear on the screen. If this happens, you should check your boot PROM revision level. The 
table below lists the minimum PROM revision level required with the various Sun architectures. 

Table 1 PROM Revision Levels for Sun Architectures 


Architecture 

Minimum PROM Level 

Sun-3/50 

1.8 

Sun-3/75 

1.8 

Sun-3/110 

1.8 

Sun-3/140 

1.8 

Sun-3/150 

1.8 

Sun-3/160 

1.8 

Sun-3/180 

1.8 

Sun-3/260 

1.8 

Sun-3/280 

1.8 

Sun-3/60 

1.6 


n 


□ How to determine your current PROM revision; 

Have your system administrator bring your system down safely; 

r --- A 

enter password 
##/etc/halt 




After the > prompt, type kb: 

>kb ( Return 1 

V_^; 


The system will respond with something like this: 

Self Test completed successfully. 

Sun Workstation, Model some number 
ROM Rev 1.8, 8MB memory installed 
and so on.,. 


Look at the ROM Rev number and compare it with the revision given for your architecture in the table above. If 
the number is less than the minimum level shown in the table, you need an upgrade kit. 

□ How to obtain an upgrade PROM kit: 

If you found that you need a new PROM and you have an On-site Hardware or Comprehensive Support contract, 
Sun will install the new PROM for you. On-site Hardware Support customers should phone the Sun Response 
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Center at 800-USA-4SUN, request Field Service, and schedule PROM installation. 

If you want to install the PROM yourself, ask for a Sun-3 PROM Upgrade Kit to be mailed to you. 


If you do not have an On-Site or Comprehensive support contract, Sun will mail you this kit at no charge. The kit 
contains instructions for replacing the Boot PROM on your CPU board, a process that takes about 10-15 minutes. You 
should call Sun’s 800 USA-4-SUN phone number, request Field Service, and ask for a Sun-3 PROM Upgrade Kit. If 
you want Sun to install the PROM, Sun will bill you on a time (but not materials) basis. 


□ PROM bugs: 

1. The Sun-3/60 Ethernet chip does not reset properly on power-up. This can be worked around by typing 1K2I in 
the PROM monitor mode. See the PROM User’s Manual for help in accessing the monitor. 

2. If you find that your PROM Revision is greater than 1.8 but lower than 2.6, and you still receive an error code 
when you try to boot from 1/4-inch tape, the problem could be caused by one of the anomalies described below; 

□ If your system contains a Sysgen Controller board and a Wangtec tape drive, and if the tape you are trying to 
load is write protected, you will receive an error message when you try to boot. 

Remove the tape and make sure it is NOT write-protected. If the boot still fails contact hardware support at 1- 
800-USA-4SIM. Outside the USA call your local support office. Please mention FA #136. 

□ If you have a Sysgen Controller and an Archive tape drive and your PROM revision level is greater than 1.8, but 
lower than 2.6, call Sun as described above and request that you receive the latest PROM revision. Please men¬ 
tion FA #135. 

□ If you have a Sun-2 shoebox connected to a Sun-3 workstation and get a tape error message, call Sun as 
described above. Please mention FA #137 and FA #138. 
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B: Sizing Your Disk Partitions 

o / (root) 

The default root filesystem size is about 8 megabytes. This size should be correct for most applications. 

□ swap 

The default swap partition size is about 16 megabytes. This should be ample for general applications. Certain 
applications will require more swap space. You can expand the size of the swap partition using the Disk Form of 
suninstall during your installation. Once the system has been installed you can add swap space using the 
procedures in this RTF. (Documentation Errata and Addenda, System and Network Administration.) 

□ /usr 

The /usr partition is expanded by suninstall to accommodate the optional software selected in the Disk 
Form of suninstall. The space needed is ‘stolen’ from the partition designated as the ‘Free Hog’, typically 
the /home partition. 

Allowing suninstall to automatically size the /usr partition by stealing from the Free Hog partition will result 
in a very full /usr partition. It is prudent to allow suninstall to size the partition and then to return to the Disk 
Form to expand the partition a bit further. Add about 8 megabytes or 10%, whichever is greater. This will allow 
room for building a custom kernel, etc. Also add space for any custom or unbundled software which you intend 
to add to the /usr filesystem. 

a / var 

The /var directory tree is intended as a repository for files which vary in size. In 4.0 all of the following are 
links into /var: /usr/adm, / usr/tmp, /usr/spool. Additionally, database files on Yellow Pages 
servers are kept in /var/yp. As installed by default, /var isaplaincBrectoryinthe root (/) filesystem. 
This risks the possibility of rapidly filling the root filesystem during normal system operation. 

It is suggested that you allocate a separate disk partition for /var. Size it based on your experience with 
/usr/adm, /usr/tmp, and /usr/spool requirements in previous releases. 

o /export 

/export is the default name on a server for the partition used to support diskless clients. It includes three pri¬ 
mary subdirectories. You may, if you wish, make each of these a separate disk partition. 

/export/exec 

This directory’s partition is grown by suninstall as optional software is selected for client systems of archi¬ 
tectures different from the server’s, much like /usr. As in the case of /usr you will want to add more space 
to accommodate kernel configuration and additional software. (Note that every standalone and server system has 
a symbolic link /export/exec/arc/itoitsown /usr partition.) 

/export/root 

This is the default name on a server for the directory used to hold diskless clients’ root partitions. Allow a 
minimum of 2 megabytes for each diskless client. 

/export/swap 

This is the default name on a server for the directory used to hold diskless clients’ swap partitions. The suggested 
size for a client’s swap area is 16 Megabytes. (Note that this is only a suggestion, requirements are system and 
application dependent.) To size this partition add up the swap sizes for the diskless clients to be supported and 
then add about 6% more room for file system overhead. 
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C: Remote Tape Installation 

1. Before beginning a remote tape installation, insert the hostname of the target system into the /. rhost s file of 
the tapehost system, creating the file if it does not exist. 

2. For remote 1/2-inch tape installation, the user should always pick remote mt 0 regardless of the actual half-inch 
tape controller type on the tapehost. 

3. For remote installations, on page 105 and 106 in Chapter 5 of Installing the SunOS, the user must specify bs 
(block size) in order for dd to copy the miniroot correctly. On page 105, the line 

dd l£a!/dev'/n3Ktaped6vice#> of^/export/exec/ARCH/Ipcal/siinlroot 
should be changed to 

dd J.£s/de'V/nr<t;aped«vlc«#> ps^blocksiz^h o£s/«acporfc/«x«c/ARCH/loeal/iiilni.zoo£ 

On page 106, the line 

dd Ifs/usr/local/mlnlroob o£«/dev/r<dis]cdevlce#>b 
should be changed to 

dd ifs/usr/local/mlnlxoot; ha’=<blocksize>b of=/dev/r<diskdevice#>b 

Block size is determined by the following; 

For stO, bs is 126. 

For st8, bsis200. 

For mtO, bs is 20. 

If the user does not specify the correct block size, the miniroot will not boot. 
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D: Kernel Configuration Procedures 

If you have never configured a kernel, read Installing the SunOS, Appendix A. Specific procedures for building a ker¬ 
nel are provided below. 

Two methods for making a customized kernel are presented on the next two pages. The first, Procedure I, builds a 
kernel on a workstation with local disk. The second. Procedure II, builds a kernel on a diskless or dataless client. 

The kernel used by a diskless client can be built on its server only if the diskless client is of the same architecture as 
the server. If a diskless client is of a different architecture from its server (heterogeneous), its kernel must be made on 
the client. 

Procedure I is simpler to perform. It requires write privileges on the woikstation /usr filesystem. Use it to build a 
kernel for: 

□ A standalone workstation 

o A server 

□ A diskless client woikstation of an architecture the same as its ^rver 

□ A dataless client woikstation of an architecture the same as its server 

Procedure II requires a little more work, but allows building a kernel without having write privileges on the /usr 
filesystem. Procedure II requires only root privileges on the client workstation; no special privileges are needed on 
the server. Use the second procedure to build a kernel for: 

□ A diskless client workstation of an architecture different from its server 

□ A dataless client workstation of an architecture different from its server 

□ A diskless or dataless client workstation when you do not have root privileges on the server 

AH procedures are performed when logged in as root (or su’d to superuser if root logins are not allowed). 

SYS_NAME, shown on the example screens following, is the name given to the custom kernel configuration file. It is 
typically chosen to match the hostname of the woikstation that wiU run the kernel. This name is automatically com¬ 
piled into the kernel and is announced when the kernel is booted. For example, a kernel made from a configuration 
file named aslan announces itself when booted as: 

- -- 

SunOS Release 4.0 (ASLAN) #1: Wed Sep 14 15:33:16 PDT 1988 

V_. 


A kernel that will be used by several client workstations of a server might be called aslan_client. 

SMB# on the example screens requires you to fill in 8un2, sun3 or sun 4, whichever is appropriate to the works¬ 
tation on which you are building the kernel. 
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o Procedure I: 

Log in as root and execute the following: 



When the make completes successfully, install the kernel. 

To install the kernel on the standalone or server workstation it was built on: 



To install the kernel on a dataless workstation of the same architecture, log onto the dataless workstation as root 
and: 

# war /vxnmilx /vmnnix.SV 

# /uax/ajfs/sanf/SFSjVAME/vnunlx /vnunix 


Now halt and reboot the workstation whose kernel you have just installed. 
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□ Procedure 11; 

The example for Procedure II makes the kernel in / sy s on the client. The client’s / sy s will be located in the 
server’s /export/root filesystem and there must be about two megabytes of disk space available in order to 
make a kernel. If space is not available in that filesystem, the procedure may be done in any filesystem which is writ¬ 
able by the client that has sufficient free space. 

Log in as root and execute the following: 

# t a fc d it /0y» 

# cd /ays 

# -a /ttSc/sya/* , 

# xm sun^ 

# tokdix sm§ 

# cd siin# 

# in -a /ttsx/aya/sira#/* . 

# xm con£ 

# mkdlx con£ 

# cd oon£ 

# m *# /ua*;/«ya/s»»#/eon£/* . 

. ■ ■■ ■ ■ ^ . ^ 


Now configure and make a kernel: 

. ^ ^ I . 

# isp GEMEftlC SrSJfAMB 

# chnod +w SVSJfAME 

# Vi SYSJtAME 
(BMouimnee<kd kernel modtdis.) 

# oonflg srsjiAm 

# cd .JSYSJiAMB 


When the make completes successfully, install the kernel: 



Halt and reboot the workstation. 


After the client has booted successfully, clean up / sy s. (You may wish to save a copy of your customized 
configuration file first): 
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E: Performance Tips 

The following reconunendations are intended to improve performance on 4MB woricstations running SunOS 4.0. 

They wiU not solve every performance problem, but many problems can be eliminated by implementing the following 
suggestions. The goal of these recommendations is to maximize the number of memory pages available to user 
processes (including SunView). 

□ Routing 


Workstations with only one ethemet interface do not need to do dynamic routing with in. routed; instead, 
they can route statically by commenting out (with the pound sign "#" in column 1) these lines in 
/etc/rc.local: 


f — 



A 


#if [ -f /usr/etc/in.routed ]; then 




# in.routed; (echo -n 'routed') 

>/dev/console 



#f i 



_ 





(Routing table entries can still be added or modified by the kernel as a result of ICMP redirect messages.) Disk¬ 
less clients have a default route provided automatically by the server; on other machines, a command of the form 




A 


/usr/etc/route add default router 1 




___^_/ 


can be added to r c. local, where router is the hostname of an IP router ("gateway") on your local network. 

This action frees up both the pages used by in. routed and most of the memory allocated for routing table 
entries. Here at Sun in Mountain View, static routing typically reduces the size of the routing table from over 
150 entries to 3. 

□ Sendmail 

Receiving mail on a diskless workstation typically causes a significant amount of paging, not only due to the 
creation of sendmail and /bin/mail processes, but also due to alias resolution and access over the net¬ 
work to the mailbox on the server. Recommendation: have each client mount its spool directory via secure 
NFS, change the YP alias map to direct users’ mail to their servers, and don’t mn sendmail on the clients. 

For example, add a line like the following to each client’s /et c/f stab: 

------- 

server:/var/spool/mail /var/spool/mail nfs rw^bg^hard^intr,secure 0 0 
^___^_____> 


Export /var/spool/mail on the server using the "secure" option. (Don’t forget to run exportf s.) 
Change or create aliases in /etc/aliases ontheYP master to provide aliases of the form 

- ^ ^ 

user: user@server 

V_______ 

for all users who would otherwise receive mail on the clients, and re-make the YP alias map (cd /var/yp; 
make aliases). Comment out these lines in each client’s /etc/rc. local and reboot the clients: 
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#if 

[ -f /usr/lib/sendmail -a -f 

/etc/sendmail.cf ]; then 

-\ 


# 

(cd /var/spool/mqueue; rm ~f 

nf* If*) 



# 

/usr/lib/sendmail -bd -qlh; 

(echo -n ' sendmail')>/dev/console 



#fi 





I 


An interestirtg side effect of this change is that a user can receive mail even if the client workstation is down. 
This change is also useful in environments where users wish to be able to log in to any machine of a cluster and 
read their mail. 


□ Accounting 

Don’t enable process accounting. If accounting is not configured into the kernel (options SYSACCT), or the 
file /var/adm/acct does not exist at boot time, accounting is not enabled (see /etc/rc). 


□ Other changes in /etc/rc. local 

Don’t start unnecessary server processes. Typically only portmap, ypbind, biod (4 of them), sys- 
logd, update, inetd, and Ipd are required on client workstations. Add keyserv if you use secure 
NFS, and sendmail if you don’t implement the sendmail strategy above. 


□ Miscellaneous 

Make sure that you have defined loghost if required as specified on page 4 of this document. 

Don’t enable file system quotas. (By default, quotas are not enabled.) Replacing /usr/ucb/quota with 
/usr/bin/true will prevent possible delays at login time due to calls to rpc.rquotad on each NFS 
server from which you have a filesystem mounted. 

Use the default SunView background, and don’t use retained windows. 

Don’t enable in. rwhod. 



□ Minimizing kernel size 

Don’t run the GENERIC kernel except to configure a smaller one! 
Kernel configuration file: 


Remove all unnecessary entries from the kernel configuration file. For example, the following lines can be 
removed from DL50 in /usr/sys/sun3/conf: 


/- 




\ 


options 

CRYPT 

(unless you use secure NFS) 



pseudo-device 

clone 




pseudo-device 

snit 




pseudo-device 

pf 




pseudo-device 

nbuf 




device 

desO at 

obio ? csr OxlcOOOO 






> 
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Streams NIT is used by etherf ind; to run etherf ind, boot another kernel or run it on the server. 


hi many cases "maxusers" can be reduced to 3: 



maxusers 

3 

N 

Also, these lines can be changed as follows: 


pseudo-device 

dtopl 



pseudo-device 

msl 



pseudo-device 

kbl 


V _ 



__/ 


Streams buffers: 

The default allocation of streams buffers is overly generous. Use the following procedure to make a kernel 
with smaller allocations. 

1. Run config using your modified configuration file. 

2. In /usr/share/sys/sun3//^£'/?N£LN/4M£/param. c, modify these lines as follows: 

( -- ----- ^ 


#define 

NBLK2048 

4 

#define 

NBLK1024 

4 

#define 

NBLK512 

4 

#define 

NBLK256 

16 

#define 

NBLK128 

64 

#define 

NBI.K64 

64 

#define 

NBLK16 

64 

#define 

NBLK4 

64 

#define 

NSTREAM 

20 

#define 

NMUXLINK 

37 

#define 

NSTREVENT 

64 


Larger allocations may be required in some environments; in some circumstances, running out can 
deadlock the system. Check your usage with netstat -m. 

3. Run make. 

Ethernet buffers: 

If you have an le Ethernet interface (Sun-3/50 or 3/60), reduce the number of Ethernet buffers: 

f -:-- ■■ ......■ '' ■ . ' ■. .... . ■" -A 

hostname# adb -w vmunlac 
^le_nrindp2?W 3 
_lejnrbufs?W A 

hostname# 
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If you have an ie Ethernet interface: 



UFS (Unix File System) buffers: 

If you have a disk, you can reduce the number of buffers allocated to the UFS buffer cache: 
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F: Distribution Tape Layout 

The following tables describe the contents of the SunOS 4.0 distribution tapes. The list is in the order in which the 
tape files appear. 


SunOS 4.0 Sun-2 Release -1/2*' Media 

Tape/ 

File 

Name 

Description 

Size 

Format 

1/0 

boot 

A general purpose bootstrap program. Boot it 
from the PROM monitor. 

26624 

image 

1/1 

XDRTOC 

Table of Contents in xdr(3N) format. 

4096 

toe 

1/2 

copy 

Standalone copy. 

33280 

image 

1/3 

mini-root 

An image of a mini version of SunOS sufficient 
to run sminstall. 

6154240 

image 

1/4 

munix 

Memory UNIX. 

696832 

image 

1/5 

munixfs 

The MUNIX initialization file. 

1581056 

image 

1/6 

root 

The complete root file system for SunOS. 

163840 

tar 

1/7 

usr 

Required /usr files. 

18872320 

tar 

1/8 

Sys 

/usr/share/sys files for making custom kernels. 

2682880 

tar 

1/9 

Networidng 

Networking tools and programs. 

962560 

tar 

1/10 

Debugging 

Debugging tools. 

3287040 

tar 

1/11 

SunView_Users 

SunWindows for users. 

1443840 

tar 

1/12 

Copyright 

The copyright file. 

512 

image 

2/0 

boot 

General purpose boot. 

26624 

image 

2/1 

XDRTOC 

Table of Contents in xdr(3N) format. 

4096 

toe 

2/2 

SunView_Programmers 

SunWindows files for programmers. 

2048000 

tar 

2/3 

SunView_Demo 

SunWindows demo programs source. 

573440 

tar 

2/4 

Text 

Text processing tools and files. 

696320 

tar 

2/5 

Install 

Installation and system administration tools. 

972800 

tar 

2/6 

User_Diag 

Sysdiag. 

931840 

tar 

2/7 

SunCore 

SunCore programmer’s files. 

2293760 

tar 

2/8 

UUCP 

UUCP files. 

276480 

tar 

2/9 

System_V 

System V compatibility files. 

4997120 

tar 

2/10 

Manual 

On-line man pages. 

6184960 

tar 

2/11 

Demo 

Assorted graphics demonstrations including 
Graphics Processor source. 

2744320 

tar 

2/12 

Games 

Game programs. 

2406400 

tar 

2/13 

Versatec 

Versatec raster printer/plotter support. 

6103040 

tar 

2/14 

Security 

C2 security support. 

153600 

tar 

2/15 

Copyright 

The copyright file. 

512 

image 
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SunOS 4.0 Sun-2 Release -1/4" Media 


Tape/ 

File 

Name 

Description 

Size 

Format 

1/0 

boot 

A general purpose bootstrap program. Boot it 
from the PROM monitor. 

26624 

image 

1/1 

XDRTOC 

Table of Contents in xdr(3N) format. 

4096 

toe 

1/2 

copy 

Standalone copy. 

33280 

image 

1/3 

mini-root 

An image of a mini version of SunOS sufficient 
to ran suninstall. 

6246400 

image 

1/4 

munix 

Memory UNIX. 

696832 

image 

1/5 

munixfs 

The MUNIX initialization file. 

1638400 

image 

1/6 

root 

The complete root file system for SunOS. 

204800 

tar 

1/7 

Copyright 

The copyright file. 

512 

image 

2/0 

boot 

General purpose boot. 

26624 

image 

2/1 

XDRTOC 

Table of Contents in xdr(3N) format. 

4096 

toe 

2/2 

usr 

Required /usr files. 

18944000 

tar 

2/3 

Copyright 

The copyright file. 

512 

image 

3/0 

boot 

General purpose boot. 

26624 

image 

3/1 

XDRTOC 

Table of Contents in xdr(3N) format. 

4096 

toe 

3/2 

Sys 

/usr/share/sys files for making custom kernels. 

2764800 

tar 

3/3 

Networking 

Networking tools and programs. 

1024000 

tar 

3/4 

Debugging 

Debugging tools. 

3379200 

tar 

3/5 

SunView_Users 

SunWindows for users. 

1536000 

tar 

3/6 

SunView_Programmers 

Sun Windows files for programmers. 

2048000 

tar 

3/7 

SunView_Demo 

SunWindows demo programs source. 

614400 

tar 

3/8 

Text 

Text processing tools and files. 

716800 

tar 

3/9 

Install 

Installation and system administration tools. 

1024000 

tar 

3/10 

User_Diag 

Sysdiag. 

1024000 

tar 

3/11 

SunCore 

SunCore programmer’s files. 

2355200 

tar 

3/12 

UUCP 

UUCP files. 

307200 

tar 

3/13 

Games 

Game programs. 

2457600 

tar 

3/14 

Copyright 

The copyright file. 

512 

image 

4/0 

boot 

General purpose boot. 

26624 

image 

4/1 

XDRTOC 

Table of Contents in xdr(3N) format. 

4096 

toe 

4/2 

System_V 

System V compatibility files. 

5017600 

tar 

4/3 

Manual 

On-line man pages. 

6246400 

tar 

4/4 

Demo 

Assorted graphics demonstrations including 
Graphics Processor source. 

2764800 

tar 

4/5 

Versatec 

Versatec raster printer/plotter support 

6144000 

tar 

4/6 

Security 

C2 security support. 

204800 

tar 

4/7 

Copyright 

The copyright file. 

512 
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SunOS 4.0 Sun-3 Release -1/2” Media 

Tape/ 

File 

Name 

Description 

Size 

Format 

1/0 

boot 

A general purpose bootstrap program. Boot it 
from the PROM monitor. 

32768 

image 

1/1 

XDRTOC 

Table of Contents in xdr(3N) format. 

4096 

toe 

1/2 

copy 

Standalone copy. 

41472 

image 

1/3 

raini-root 

An image of a mini version of SunOS sufficient 
to ran suninstall. 

6154240 

image 

1/4 

munix 

Memory UNIX. 

737792 

image 

1/5 

raunixfs 

The MUNIX initialization file. 

1581056 

image 

1/6 

root 

The complete root file system for SunOS. 

163840 

tar 

1/7 

usr 

Required /usr files. 

18780160 

tar 

1/8 

Sys 

/usr/share/sys files for making custom kernels. 

2795520 

tar 

1/9 

Networking 

Networking tools and programs. 

962560 

tar 

1/10 

Debugging 

Debugging tools. 

3256320 

tar 

1/11 

SunView_Users 

SunWindows for users. 

1443840 

tar 

1/12 

Copyright 

The copyright file. 

512 

image 

2/0 

boot 

General purpose boot. 

32768 

image 

2/1 

XDRTOC 

Table of Contents in xdr(3N) format. 

4096 

toe 

2/2 

SunView_Prograraraers 

SunWindows files for programmers. 

2048000 

tar 

2/3 

SunView_Derao 

SunWindows demo programs source. 

573440 

tar 

2/4 

Text 

Text processing tools and files. 

696320 

tar 

2/5 

Install 

Installation and system administration tools. 

972800 

tar 

2/6 

User_Diag 

Sysdiag. 

1464320 

tar 

2/7 

SunCore 

SunCore programmer’s files. 

2908160 

tar 

2/8 

UUCP 

UUCP files. 

276480 

tar 

2/9 

Systera_V 

System V compatibility files. 

4945920 

tar 

2/10 

Manual 

On-line man pages. 

6184960 

tar 

2/11 

Demo 

Assorted graphics demonstrations including 
Graphics Processor source. 

2744320 

tar 

2/12 

Games 

Game programs. 

2396160 

tar 

2/13 

Versatec 

Versatec raster printer/plotter support. 

6092800 

tar 

2/14 

Security 

C2 Kicurity support. 

153600 

tar 

2/15 

Copyright 

The copyright file. 

512 
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SunOS 4.0 Sun-3 Release - 1/4" Media 

Tape/ 

File 

Name 

Description 

Size 

Format 

1/0 

boot 

A general purpose bootstrap program. Boot it 
from the PROM monitor. 

32768 

image 

1/1 

XDRTOC 

Table of Contents in xdr(3N) format. 

4096 

toe 

1/2 

copy 

Standalone copy. 

41472 

image 

1/3 

mini-root 

An image of a mini version of SunOS sufficient 
to run sminstall. 

6246400 

image 

1/4 

munix 

Memory UNIX. 

737792 

image 

1/5 

munixfs 

The MUNIX initialization file. 

1638400 

image 

1/6 

root 

The complete root file system for SunOS. 

204800 

tar 

1/7 

usr 

Required /usr files. 

18841600 

tar 

1/8 

Sys 

/usr/share/sys files for making custom kernels. 

2867200 

tar 

1/9 

Networking 

Networking tools and programs. 

1024000 

tar 

1/10 

Debugging 

Debugging tools. 

3276800 

tar 

1/11 

SunView_Users 

SunWindows for users. 

1536000 

tar 

1/12 

SimView_Programmers 

SunWindows files for programmers. 

2048000 

tar 

1/13 

SunView_Demo 

SunWindows demo programs source. 

614400 

tar 

1/14 

Text 

Text processing tools and files. 

716800 

tar 

1/15 

Install 

Installation and system administration tools. 

1024000 

tar 

1/16 

User_Diag 

Sysdiag. 

1536000 

tar 

1/17 

SimCore 

SunCore programmer’s files. 

2969600 

tar 

1/18 

UUCP 

UUCP files. 

307200 

tar 

1/19 

Copyright 

The copyright file. 

512 

image 

2/0 

boot 

General purpose boot 

32768 

image 

2/1 

XDRTOC 

Table of Contents in xdr(3N) format 

4096 

toe 

2/2 

System_V 

System V compatibility files. 

5017600 

tar 

2/3 

Manual 

On-Une man pages. 

6246400 

tar 

2/4 

Demo 

Assorted graphics demonstrations including 
Graphics Processor source. 

2764800 

tar 

2/5 

Games 

Game programs. 

2457600 

tar 

2/6 

Versatec 

Versatec raster printer/plotter support. 

6144000 

tar 

2/7 

Security 

C2 security support. 

204800 

tar 

2/8 

Copyright 

The copyright file. 

512 
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SunOS 4.0 Sun-4 Release ■ 1/2” Media 

Tape/ 

File 

Name 

Description 

Size 

Format 

1/0 

boot 

A general purpose bootstrap program. Boot it 
from the PROM monitor. 

40960 

image 

1/1 

XDRTOC 

Table of Contents in xdr(3N) format. 

4096 

toe 

1/2 

copy 

Standalone copy. 

49664 

image 

1/3 

mini-root 

An image of a mini version of SunOS sufficient 
to run suninstall. 

6154240 

image 

1/4 

munix 

Memory UNIX. 

942592 

image 

1/5 

munixfs 

The MUNIX initialization file. 

1581056 

image 

1/6 

root 

The complete root file system for SunOS. 

163840 

tar 

1/7 

usr 

Required /usr files. 

18974720 

tar 

1/8 

Sys 

/usr/share/sys files for making custom kernels. 

3194880 

tar 

1/9 

Networking 

Networking tools and programs. 

1024000 

tar 

1/10 

Debugging 

Debugging tools. 

4270080 

tar 

1/11 

SunView_Users 

SunWindows for users. 

1495040 

tar 

1/12 

SunView_Programmers 

SunWindows files for programmers. 

2314240 

tar 

1/13 

SunView_Demo 

SunWindows demo programs source. 

573440 

tar 

1/14 

Text 

Text processing tools and files. 

768000 

tar 

1/15 

Install 

Installation and system administration tools. 

1054720 

tar 

1/16 

User_Diag 

Sysdiag. 

1628160 

tar 

1/17 

SunCore 

SunCore programmer’s files. 

1781760 

tar 

1/18 

UUCP 

UUCP files. 

286720 

tar 

1/19 

System_V 

System V compatibility files. 

5314560 

tar 

1/20 

Manual 

On-line man pages. 

6184960 

tar 

1/21 

Demo 

Assorted graphics demonstrations including 
Graphics Processor source. 

2754560 

tar 

1/22 

Games 

Ganae programs. 

2580480 

tar 

1/23 

Versatec 

Versatec raster printer/plotter support. 

6103040 

tar 

1/24 

Security 

C2 security support. 

184320 

tar 

1/25 

Copyright 

The copyright file. 

512 
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SunOS 4.0 Sun-4 Release - 1/4" Media 

Tape/ 

File 

Name 

Description 

Size 

Format 

1/0 

boot 

A general purpose bootstrap program. Boot it 
from the PROM monitor. 

40960 

image 

1/1 

XDRTOC 

Table of Contents in xdr(3N) format. 

4096 

toe 

1/2 

copy 

Standalone copy. 

49664 

image 

1/3 

mini-root 

An image of a mini version of SunOS sufficient 
to run suninstall. 

6246400 

image 

1/4 

munix 

Memory UNIX. 

942592 

image 

1/5 

munixfs 

The MUNIX initialization file. 

1638400 

image 

1/6 

root 

The complete root file system for SunOS. 

204800 

tar 

1/7 

usr 

Required /usr files. 

19046400 

tar 

1/8 

Sys 

/usr/share/sys files for making custom kernels. 

3276800 

tar 

1/9 

Networking 

Netwoiking tools and programs. 

1024000 

tar 

1/10 

Debugging 

Debugging tools. 

4300800 

tar 

1/11 

SunView_Users 

SunWindows for users. 

1536000 

tar 

1/12 

SunView_Programmers 

SunWindows files for programmers. 

2355200 

tar 

1/13 

SunView_Demo 

SimWindows demo programs source. 

614400 

tar 

1/14 

Text 

Text processing tools and files. 

819200 

tar 

1/15 

Copyright 

The copyright file. 

512 

image 

2/0 

boot 

General purpose boot 

40960 

image 

2/1 

XDRTOC 

Table of Contents in xdr(3N) format. 

4096 

toe 

2/2 

Install 

Installation and system administration tools. 

1126400 

tar 

2/3 

User_Diag 

Sysdiag. 

1638400 

tar 

2/4 

SunCore 

SunCore programmer’s files. 

1843200 

tar 

2/5 

UUCP 

UUCP files. 

307200 

tar 

2/6 

System_V 

System V compatibility files. 

5324800 

tar 

2/7 

Manual 

On-line man pages. 

6246400 

tar 

2/8 

Demo 

Assorted graphics demonstrations including 
Graphics Processor source. 

2764800 

tar 

2/9 

Games 

Game programs. 

2662400 

tar 

2/10 

Versatec 

Versatec raster printer/plotter support. 

6144000 

tar 

2/11 

Security 

C2 security support. 

204800 

tar 

2/12 

Copyright 

The copyright file. 

512 

image 
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G: SunOS 4.0.1 Bugfix ERRATA 

The text of the ERRATA for SunOS Release 4.0.1 follows. 
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SunOS Release 4.0.1 ERRATA 


Introduction 

SunOS™ Release 4.0.1 contains fixes for bugs reported against SunOS 4.0. It applies to Sun-2™, Sun-3™, and 
Sun-4™ workstations. 

This document includes important information on installing the fixes, post-installation procedures, dependencies, and 
kernel rebuilding. Read it carefully before you begin your upgrade. 

Getting Help 

If you have any problems installing or using this release, call Sun Microsystems at 1-800-USA-4SUN (1-800-872- 
4786). Have your system’s model number, release number for software, and Sun operating system—SunOS—^release 
number ready to give to the dispatcher. 

You can also send questions by electronic mail to sun! hotline. Be sure to include your name, company, phone 
number, release niunber, and SunOS release number in your mail message. 

If you have questions about Sun’s support services or your shipment, call your sales representative. 

To see the SunOS release number, key in cat /etc/motd. 


Installing the 4.0.1 Fixes 

SunOS Release 4.0.1 is a collection of individual patches rather than a monolithic release or upgrade. Related fixes 
are identified by a keyword and are individually installable using the program install_f ix sujplied on the 4.0.1 
tape. The keywords, the files which are affected when a keyword is selected for installation, and a list of the bugs 
addressed by each keyword are all documented in the README file. Extract and study the README to decide 
which of the patches you’ll want to install on your system. 

If you elect to install aU of the patches you may do so by executing inst all_f ix without arguments and respond¬ 
ing ‘ y ’ to each fix in turn. 

Read and understand the Post-Installation Procedures section of the document before installing the 4.0.1 fixes. 
In particular, on Sun-3 systems be sure to run installboot before rebooting the system. 

Extracting the README Document 

The release tape contains a README file with descriptions and installation instmctions for each fix; it is important 
that you read this file before updating your system with the 4.0.1 fixes. 
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Mount the release tape in your tape drive and t ar (1) off the README file fior printing or viewing with this com¬ 
mand sequence: 



% Cd /tap 

% mt -f /dev/nrrfevfcc rew 
% nt -f /dev/nrdevfc^ tat 2 
% tar scvpf /dBv/nxdevice README 

device is one of the types given in Table 1 below. 


Table 1 Tape Device Types 


Architecture 

Tape 

Device 

Blocksize 

Sun-4 

1/2" 

mtS 

20 

Sun-4 

1/4" 

st8 

200 

Sun-3 

1/2" 

mtO 

20 

Sun-3 

1/4" 

st8 

200 

Sun-2 

1/2" 

mtO 

20 

Sun-2 

1/4" (Archive) 

arO 

126 

Sun-2 

1/4" (others) 

stO 

126 


Remove the tape from the drive and print out the README file. 


Saving Current Fihs 

As always, you should have a current backup of your system on hand prior to performing the upgrade. 
Extracting the Installation Scripts 

Follow the procedures given in the next sections to extract the 4.0.1 installation scripts. 


Local Tape Installation 

1. Become superuser and halt the system. 

If the system is a server, halt all client workstations before halting the system. 

........... .■ 

# /etc/halt 

s_ 


2. Reboot and bring the system up in single-user mode; disk is selected from the devices in Table 2 below: 

>b duA:<0,0,0)vmunlx -a 

S- J 




Revision A, 20 January 1989 Part No: 800-3823-10 






4.0.1 Bugfix ERRATA 31 


Table 2 Disk Devices 


Devices 

Description 

xy 

Xylogics 450/451 SMD disk controller 

xd 

Xylogics 7053 VME/SMD disk controller 

sd 

SCSI disk controller 


The boot completes in single-user mode. 


3. Moimt the tape appropriate to your workstation’s architecture in the drive and type the following: 


f .^.. , , i.u.n., n u, i..m ...ii 

# cd /etc 

' •" ‘..-k 

# lilt -f /d 0 v/tixdevlce taw 


# ittt -f /dnv/xucdevice tat Z 


# tat /d»9/tixdevice blockrize 


s_ f _ ; 



device is one of the types given in Table 1. 
blocksize is as specified in Table 1. 


This tars the following four files into /etc: 

D install_f ix, the file which installs the fixes contained in the release. 

o remove_f ix, the file which allows you to back out the fixes you have installed and replaces the 4.0 

binaries for these modules. 

□ read_inf o, the file which parses information from the README file for the scripts. You do not have 
to be concerned with this file. 

□ README , the file descritdng all the fixes available in 4.0.1, as well as special installation instructions for 
many of them. You must read this file before installing the release. 

4. Now execute install_fix: 

.' . ' ' ' " " , , , .,. ,.u. n u .. ^ .I , , 

# install fix 


Remote Tape Installation 

For a remote installation, use this procedure: 

1. Remote installation in single-user mode requires that these network files be properly set up: 

□ On the machine you are updating, /etc/hosts must include the internet number and hostname of the 
machine with the tape drive. 

□ On the machine whose tape drive you are using, /. r ho st s must include the hostname of the system you 
are updating. 
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2. Become superaser and halt the system. If the system is a server, make sure to halt all clients before halting the 
system. 

# /etc/baXfc 



3. Reboot to bring the system up in single user mode; disk is selected from Table 2: 

.' 

>b disk{0f0,0)vmxaix -a 
The boot completes in single-user mode. 



4. Now configure the network interface: 

. .. . " ■ "" ■ ." .'.. ■ ■ 

# /etc/l£con.£lg intetface Hostname up -trailers 

S..:...--- - 

interface leO, laO, or acO, depending on your Ethernet interface type. 
hostname is the name of the system you are updating. 

More information on if conf ig is in Section 8 of the SunOS Reference Manual. 


5. Mount the filesystems, and then tar the script files into /etc: 

. . .. 

# mount -a 

# cd /etc 

# rsh tapehost xnt *■£ /dev/nrdevtc« raw 

# rsh tapehost mt -£ /dev/nrdevlc« £s£ 2 

# rsh tapehost -n dd L£.’»/dav/ardevice ha<>‘btoekskel> I tar xvp£B - 

k:_-. . . 

uyjehost above is the name of the system with the tape drive. 
device is selected from Table 1. 
blocksize as found in Table 1. 


6. Now execute install_fix: 

# install_£i* 

i.___ ^ 


n 
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Post-Installation Procedures 

The following condenses the individual Special Installation Instmctions listed in the README document Once the 
install_f ix script has completed, perform the following procedures. 

a Before rebooting your system; 

On Sun-3 workstations only: 

If you have installed the Igkernel fix, you must install the new boot block. To do this, key in the conunands on 
the display below. 

# ed /tis£/radec 

t Inst allboot /boot bootdd /dev/xdlifOa 

... ^ 

dd on the screen above is sd, xy, or xd, as shown in Table 2. 

If your Sun-3 is equipped with a Roaring Point Accelerator (FPA) board and you have installed the fpaload fix, 
you will need to merge changes into jrour /etc/rc. local. The rKw rc. local was left in 
/usr/share/tmp/sun3 by install_fix. Compare the two. The only change from the standard version of 
rc. local as shipped with StmOS 4.0 is the addition of this line: 


r 

(echo 'initializing fpa board ...') >/dev/console 

\_:_ 

_ j 

The line is sdded immediately following line 91 of rc. local which reads: 

r 

if [ -f /dev/fpa ]; then 


V_:_ 

J 


On all workstations: 

Rebuild your kernel. Be sure to keep a copy of your current, working kernel in the root directory (as /vmunix. SV, 
for example) to boot in case of problems with the new kernel. Refer to the Kernel Rebuild Procedures section of this 
document. 

o After rebooting your system: 

Relink any statically linked programs in which you wish to incorporate library fixes. Dynamically linked programs 
will pick up the fixes automatically. 

Make sure that the yellow pages maps which will support flie nameserver are built with the -b flag to makedbm. 
Refer to manual page named (8). 

□ Each time you use the format (8 S) program: 

The new format program must be reinstalled each time it is run while booted from MUNIX or from the miniroot 
The quickest way to do this is to t ar a copy of the 4.0.1 f orma t program to a scratch tape. Then, once MUNIX or 
the miniroot is up and running, tar back the new format program over the old one in /usr/etc/format. 
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Bugs Fixed in SunOS Release 4.0.1 

A list of the bugs fixed by this release appears in the README file. The bug descriptions are arranged in alphabetical 
Older by keyword. They are further listed in ascending bug reference numerical order within each keyword heading. 

Each bug is described by the five kinds of information shown below. Note that when ‘Special Installation Instruc¬ 
tions’ are given for the bug, these MUST be completed correctly to install the fix. 

Reference Number: nnnnnnn 
S)mopsis: 

Description: 

Files Changed: 

Special Installation Instructions: 

Instructions, or ‘None required.’ 


Fix Dependencies and ‘Be-Awares’ 

□ Page 4 of the SunOS Release 4.0 READ THIS FIRST (800-1737-15 or 800-1737-16) mentions a modification 
needed if your workstation is a Sun-3/2xx or a Sun-4/2xx configured with an SMD disk plus two or more SCSI 
devices. The ‘scsi’ fix in SunOS 4.0.1 supersedes this modification (the SCSI/ALM-2 Patch Tape part #700- 
1873-10). Additionally, the ‘serial’ fix in SunOS 4.0.1 supersedes the ALM-2 fix on the SCSI/ALM-2 Patch 
Tape. If you do not have this Patch Tape you do not need it. If you have previously installed this Patch Tape, 
simply install the 4.0.1 ‘scsi’ and ‘serid’ fixes over it to get the preferred 4.0.1 fixes. 

□ If you install the ‘ sysdiagp’ fix, you must also install the ‘serial’ patch. 

o If you install the ‘dbx’ fix without installing the ‘winlibs’ fix, when dbxtool (1) executes you will receive 

the warning message: 

— ------ - ^--— ---^— -) 

Id.so: warning: /usr/lib/libsuntool.so.0.28 has older revision than expected 30 

_ : ___ 


This message is expected in this case and not a cause for concern. Installing the ‘winlibs’ fix will prevent the 
error message from occurring. 

□ When compiling programs which use the simtools libraries, you may receive this warning message: 


- \ 

Id: /lib/libsuntool.sa.0.30: warning: table of contents for archive is 
out of date; rerun ranlib(l) 



To prevent the warning from being displayed, become superuser and execute the following: 


# ranlib -t /lib/libsuntooX.ua.O.SO 
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Kernel Rebuild Procedures 

The ‘Special Installation Instructions’ given for many of the bug fixes require rebuilding the kernel. If you have never 
configured a kernel, read Installing the SunOS, Appendix A. Specific procedures for rebuilding a kernel are provided 
below. 

Making Custom Kernels 

Two methods for making a customized kernel are shown on the next two pages. The first, Procedure I, builds a kernel 
on a workstation with local disk. The second. Procedure II, builds a kernel on a diskless or dataless client. 

The kernel used by a diskless client can be built on its server only if the diskless client is of the same architecture as 
the server. If a diskless client is of a different architecture from its server (heterogeneous), its kernel must be made on 
the client. 

Procedure I is simpler to perform. It requires write privileges on the workstation /usr filesystem. Use it to build a 
kernel for: 

p A standalone workstation 

□ A server 

□ A diskless client workstation of an architecture the same as its server 

□ A dataless client workstation of an architecture the same as its server 

Procedure II requires a little more work, but allows building a kernel without having write privileges on the /usr 
, filesystem. Procedure II requires only root privileges on the client workstation; no special privileges are needed on 
the server. Use the second procedure to build a kernel for: 

□ A diskless client workstation of an architecture different from its server 

o A dataless client workstation of an architecture different from its server 

□ A diskless or dataless client workstation when you do not have root privileges on the server 

AH procedures are performed when logged in as root (or su’d to superuser if root logins are not allowed). 

SYS_NAME, shown on the example screens following, is the name given to the custom kernel configuration file. It is 
typically chosen to match the hostname of the workstation that will run the kernel. This name is automatically com¬ 
piled into the kernel and is announced when the kernel is booted. For example, a kernel made from a configuration 
file named as lan announces itself when booted as: 

/ ..— ■» 

SunOS Release 4.0 (ASLAN) #1: Wed Sep 14 15:33:16 PDT 1988 

V___ i 


A kernel that will be used by several client workstations of a server might be called aslan_client. 

sun§ on the example screens requires you to fill in sun2, sun3 or 8un4, whichever is appropriate to the works¬ 
tation on which you are building the kernel. 
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□ Procedure I: ’ 


Log in as root and execute the following: 


# cd /uer/9ys/s««#/conf 

# cp GENERIC SrSJfAMB 

’I 

# ciawxJ +if sYSjfAm 


# Vi SYSjiAMB 


(Edit om mmeded kernel modides,} 


# conf ig SrSJiAMB 


# cd .jsrsjiAMB 


#.,.aiake.- 


V ___________^ 



When the make completes successfully, install the kernel. 


To install the kernel on the standalone or server workstation it was built on: 



To install the kernel on a diskless client woikstation of the same architecture: 


# aw /eaport/roofe/sysjVMME/vmanJjt /eapoirti/root/mjVAME/vaiunije.SV 

# cp vaninlx /export/root/STSJVAME/vamnix 



To install the kernel on a dataless workstation of the same architecture, log onto the dataless workstation as root 
and: 

f ■ •' •• ■ ■ ■" " .'.'.•' .■■ .'■'..“.“ • ■■■■".".‘.‘. *'. ' “ ■ ‘ ‘ '"■*. 

# aw /vanmix /vaiunix.Str 

# /uar/sys/sai#/SFSjVAJ»#E/wnmiix /viaiinlx 

V_^^ 

Now halt and reboot the workstation whose kernel you have just installed. 
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□ Procedure 11: 

The example for Procedure II makes the kernel in / sy s on the client. The client’s / sys will be located in the 
server’s /export / root filesystem and there must be about two megabytes of disk space available in order to 
make a kernel. If space is not availaMe in that filesystem, the procedure may be done in any filesystem which is writ¬ 
able by the client that has sufficient free space. 

Log in as root and execute the following: 

fiKsSSSBSSjSsSSSsSsi®®;:;;;;:;:;:® 

# nkdlr /sy» 

# cd /sys 

# In -8 /usjr/sys/* . 

# xm sun# 

# sdcdir mn^ 

# cd suit# 

# In -s /use/sys/swa#/* . 

# xm con£ 

# xnkdii: conf 

# cd conf 

# In -s /Tisx/sys/s«n#/conf/* . 


Now configure and make a kernel: 


r . . ' ■ "" ".' ' ... " ' ■ -M I .1 . .M, 

It 

# cp GENERIC SYSJtAME 

# chmod +w SYSJfAME 

# Vi SESJfAME 

(Edit out unneeded kernel modules,) 

# conf ig SYS_NAME 

# cd .JSYSJfAME 

# make 


.. .= ,,,, .-... 

.. J 

When the make completes successfully, install the kernel: 


r' ' ■ 

# mv /vmuniac /vmmxx.BV 


# cp /vzminix 

V_ ^ ... : - : - 

__!.. ^ 


Halt and reboot the workstation. 


After the client has booted successfully, clean up / sys. (You may wish to save a copy of your customized 
configuration file first): 
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